@polymer/iron-selector
Advanced tools
IronSelectableBehavior, IronMultiSelectableBehavioriron-selector is an element which can be used to manage a list of elements
that can be selected. Tapping on the item will make the item selected. The
selected indicates which item is being selected. The default is to use the
index of the item. iron-selector's functionality is entirely defined by
IronMultiSelectableBehavior.
IronSelectableBehavior gives an element the concept of a selected child
element. By default, the element will select one of its selectable children
when a 'tap'
event
(synthesized by Polymer, roughly 'click') is dispatched to it.
IronSelectableBehavior lets you ...
selectable),selectedItem) and all elements
in the selectable set (items),select, selectNext, etc.),selectedClass, selectedAttribute),... among other things.
IronMultiSelectableBehavior includes all the features of
IronSelectableBehavior as well as a multi property, which can be set to
true to indicate that the element can have multiple selected child elements.
It also includes the selectedItems and selectedValues properties for
working with arrays of selectable elements and their corresponding values
(multi is true) - similar to the single-item versions provided by
IronSelectableBehavior: selectedItem and selected.
See: Documentation, Demo.
npm install --save @polymer/iron-selector
<html>
<head>
<script type="module">
import '@polymer/iron-selector/iron-selector.js';
</script>
</head>
<body>
<iron-selector selected="0">
<div>Item 1</div>
<div>Item 2</div>
<div>Item 3</div>
</iron-selector>
</body>
</html>
import {PolymerElement} from '@polymer/polymer/polymer-element.js';
import {html} from '@polymer/polymer/lib/utils/html-tag.js';
import '@polymer/iron-selector/iron-selector.js';
class ExampleElement extends PolymerElement {
static get template() {
return html`
<iron-selector selected="0">
<div>Item 1</div>
<div>Item 2</div>
<div>Item 3</div>
</iron-selector>
`;
}
}
customElements.define('example-element', ExampleElement);
If you want to send a PR to this element, here are the instructions for running the tests and demo locally:
git clone https://github.com/PolymerElements/iron-selector
cd iron-selector
npm install
npm install -g polymer-cli
polymer serve --npm
open http://127.0.0.1:<port>/demo/
polymer test --npm
FAQs
Manages a set of elements that can be selected
The npm package @polymer/iron-selector receives a total of 14,701 weekly downloads. As such, @polymer/iron-selector popularity was classified as popular.
We found that @polymer/iron-selector demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 11 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.